home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / fccli.z / fccli
Encoding:
Text File  |  2001-04-17  |  10.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ffffcccccccclllliiii((((1111mmmm))))                                                            ffffcccccccclllliiii((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffcccccccclllliiii - FibreVault Status/Configuration Command Line Interface
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      The command line syntax of ffffcccccccclllliiii takes multiple flavors depending on the
  14.      use.
  15.  
  16.      ffffcccccccclllliiii ggggeeeettttvvvveeeerrrrssssiiiioooonnnn [----hhhh _h_o_s_t_n_a_m_e]
  17.      ffffcccccccclllliiii ggggeeeettttssssttttaaaattttuuuussss [----hhhh _h_o_s_t_n_a_m_e] [----cccc _c_h_a_n_n_e_l-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D]]
  18.      ffffcccccccclllliiii _c_o_m_m_a_n_d [----hhhh _h_o_s_t_n_a_m_e] ----cccc _c_h_a_n_n_e_l-_I_D ----tttt _t_i_d__1 [_t_i_d__2 .. [_t_i_d__n]]
  19.  
  20.      where _c_o_m_m_a_n_d is one of the following:
  21.                     iiiinnnnsssseeeerrrrtttt, rrrreeeemmmmoooovvvveeee, lllleeeeddddoooonnnn, lllleeeeddddooooffffffff, ffffllllaaaasssshhhh, bbbbyyyyppppaaaassssssss, uuuunnnnbbbbyyyyppppaaaassssssss.
  22.  
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      ffffccccaaaaggggeeeennnntttt and ffffcccccccclllliiii have been deprecated in favor of a new fibre channel
  26.      drive manager sssseeeessssddddaaaaeeeemmmmoooonnnn and sssseeeessssmmmmggggrrrr.  Accordingly, fcagent is now
  27.      chkconfig off by default.
  28.  
  29.      The fccli command is a user front end to ffffccccaaaaggggeeeennnntttt which collects status of
  30.      all FibreVault enclosures and allows for configuration changes.
  31.  
  32.  
  33. CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  34.      ggggeeeettttvvvveeeerrrrssssiiiioooonnnn     this command will report the version level of ffffccccaaaaggggeeeennnntttt.
  35.  
  36.      ggggeeeettttssssttttaaaattttuuuussss      this command reports status of FibreVault enclosures. The
  37.                     interface is in the form of a hierarchy where the user can
  38.                     get brief summary channel status at one extreme and
  39.                     detailed enclosure status at the other extreme.
  40.  
  41.      rrrreeeemmmmoooovvvveeee         this command will prepare a drive for physical removal,
  42.                     i.e. will spin-down the specified disk drive, and bypass
  43.                     it to logically remove it from the FC loop.
  44.  
  45.      iiiinnnnsssseeeerrrrtttt         this command will prepare a drive for operation, after
  46.                     being physically introduced into the enclosure, i.e. will
  47.                     unbypass it to logically introduce it onto the FC loop and
  48.                     spin it up.
  49.  
  50.      lllleeeeddddoooonnnn          this command will turn "ON" the amber "LED" associated
  51.                     with the specified disk device.
  52.  
  53.      lllleeeeddddooooffffffff         this command will turn "OFF" the amber "LED" associated
  54.                     with the specified disk device.
  55.  
  56.      ffffllllaaaasssshhhh          this command will "FLASH" the amber "LED" associated with
  57.                     the specified disk device. This "flashing" mode will
  58.                     persist until either an lllleeeeddddoooonnnn or lllleeeeddddooooffffffff command is issued.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffcccccccclllliiii((((1111mmmm))))                                                            ffffcccccccclllliiii((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      bbbbyyyyppppaaaassssssss         this command will logically remove the specified disk
  75.                     device from the FC loop.
  76.  
  77.      uuuunnnnbbbbyyyyppppaaaassssssss       this command will logical introduce the specified disk
  78.                     device onto the FC loop.
  79.  
  80.  
  81. OOOOTTTTHHHHEEEERRRR CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  82.      ----hhhh _h_o_s_t_n_a_m_e    use this option to communicate with an instance of ffffccccaaaaggggeeeennnntttt
  83.                     running on a remote machine.
  84.  
  85.      ----cccc _c_h_a_n_n_e_l-_I_D  use this option to direct a command at a particular FC
  86.                     channel.
  87.  
  88.      ----eeee _e_n_c_l_o_s_u_r_e-_I_D
  89.                     use this option (ggggeeeettttssssttttaaaattttuuuussss command only) in conjunction
  90.                     with the ----cccc option to obtain more detailed status about a
  91.                     particular enclosure.
  92.  
  93.      ----tttt _t_i_d__1 [_t_i_d__2 .. [_t_i_d__n]]
  94.                     use this option(s) (iiiinnnnsssseeeerrrrtttt, rrrreeeemmmmoooovvvveeee, lllleeeeddddoooonnnn, lllleeeeddddooooffffffff, ffffllllaaaasssshhhh,
  95.                     bbbbyyyyppppaaaassssssss, uuuunnnnbbbbyyyyppppaaaassssssss commands only) in conjunction with the ----cccc
  96.                     option to direct an action at a particular drive or set of
  97.                     drives.
  98.  
  99.  
  100. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  101.      Obtaining the revision level of the instance of ffffccccaaaaggggeeeennnntttt running on remote
  102.      machine betelguese:
  103.  
  104.           ffffcccccccclllliiii ggggeeeettttvvvveeeerrrrssssiiiioooonnnn ----hhhh bbbbeeeetttteeeellllgggguuuueeeesssseeee
  105.  
  106.           sample output:
  107.  
  108.           FC JBOD Agent version 1.0, Mon May 19 17:16:48 PDT 1997
  109.  
  110.  
  111.  
  112.      Obtaining a brief channel status summary:
  113.  
  114.           ffffcccccccclllliiii ggggeeeettttssssttttaaaattttuuuussss
  115.  
  116.           sample output:
  117.  
  118.           CHANNEL | DRIVES    POWER     FANS      PEER LCC
  119.           --------+-----------------------------------------
  120.              24   |   OK       FAIL      OK         OK
  121.              25   |
  122.  
  123.      The example shows that channel 24 has one or more enclosures reporting a
  124.      power supply fault. Channel 25 shows no status which indicates one of
  125.      three possibilities.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ffffcccccccclllliiii((((1111mmmm))))                                                            ffffcccccccclllliiii((((1111mmmm))))
  137.  
  138.  
  139.  
  140.      o  There are no FC device(s) connect to the channel.
  141.      o  There are no FibreVaults(s) connect to the channel (e.g. fibre RAID
  142.         may be connected).
  143.      o  There is a communication problem with the FibreVault.
  144.  
  145.      Obtaining a more detailed enclosure summary of channel 24:
  146.  
  147.           ffffcccccccclllliiii ggggeeeettttssssttttaaaattttuuuussss ----cccc 22224444
  148.  
  149.           sample output:
  150.  
  151.           ENCLOSURE | DRIVES    POWER     FANS      PEER LCC
  152.           ----------+-----------------------------------------
  153.                 4   |   OK       FAIL      OK         OK
  154.                 5   |   OK       FAIL      OK         OK
  155.  
  156.      The example shows two connected FibreVault enclosures connected to
  157.      channel 24, IDs 4 and 5, with a power supply fault in each. It should be
  158.      noted that ffffcccccccclllliiii cannot differentiate between a failed power supply and
  159.      one that is present but powered down.
  160.  
  161.  
  162.      Obtaining a detailed status of enclosure 4 on channel 24:
  163.  
  164.           ffffcccccccclllliiii ggggeeeettttssssttttaaaattttuuuussss ----cccc 22224444 ----eeee 4444
  165.  
  166.           sample output:
  167.  
  168.            Enclosure 4, status FAIL
  169.            Vendor ID:     CLARiiON
  170.            Product ID:    DISK ENC
  171.            LCC SN#:
  172.            LCC Mfg. Date:
  173.            LCC code rev:  003
  174.            FRUs:          10 disk slot(s)
  175.                           1 fan slot(s)
  176.                           2 power supply slot(s)
  177.                           1 peer LCC slot(s)
  178.  
  179.            +---------------------------------------+------+
  180.            | [ 4] FAIL                             |      |
  181.            +---------------------------------------+      |
  182.            |   |   |   |   |   |   |   |   |   |   | P    |
  183.            | O | O | O | O | O | O | O | O | B | B | E  L |
  184.            | K | K | K | K | K | K | K | K | P | P | E  L |
  185.            | 40| 41| 42| 43| 44| 45| 46| 47| 48| 49| R  C |
  186.            +---------------------------------------+      |
  187.            |               FANS  OK                |  OK  |
  188.            |      PS0 FAIL           PS1  OK       |      |
  189.            +---------------------------------------+------+
  190.  
  191.      The example shows a power supply fault on power supply FRU 0.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ffffcccccccclllliiii((((1111mmmm))))                                                            ffffcccccccclllliiii((((1111mmmm))))
  203.  
  204.  
  205.  
  206.      Additionally, disk FRUs 48 and 49, although physically present, have been
  207.      bypassed.
  208.  
  209.  
  210.      Illuminating the amber LEDs associated with disk FRUs 45-49 on channel
  211.      24:
  212.  
  213.           ffffcccccccclllliiii lllleeeeddddoooonnnn ----cccc 22224444 ----tttt 44445555 44446666 44447777 44448888 44449999
  214.  
  215.  
  216.  
  217. FFFFIIIILLLLEEEESSSS
  218.      /usr/sbin/fccli
  219.  
  220.  
  221. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  222.      fcagent(1M), sesdaemon(1M), sesmgr(1M)
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.